.\" Copyright 1999,2005 Red Hat Software, Inc.
.\" Written by Michael K. Johnson <johnsonm@redhat.com>
.TH console.perms 5 2005/5/2 "Red Hat Software" "System Administrator's Manual"
.SH NAME
console.perms \- permissions control file for users at the system console
.SH DESCRIPTION
/etc/security/console.perms and .perms files in the
/etc/security/console.perms.d directory determine the permissions that will be
given to priviledged users of the console at login time, and the
permissions to which to revert when the users log out.  They are
read by the pam_console_apply helper executable.

The format is:

\f(CR<\fBclass\fR\f(CR>=\fBspace-separated list of words\fR

\fBlogin-regexp\fR\fI|\fR\f(CR<\fBlogin-class\fR\f(CR> \fBperm dev-glob\fR\fI|\fR\f(CR<\fBdev-class\fR\f(CR> \e
.br
\f(CR        \fBrevert-mode revert-owner\fR\fI[\fR\fP.revert-group\fI]\fR

The \fBrevert-mode\fP, \fBrevert-owner\fP, and revert-group fields are optional,
and default to \fB0600\fP, \fBroot\fP, and \fBroot\fP, respectively.

The words in a class definition are evaluated as globs if they
refer to files, but as regular expressions if they apply to a
console definition.  Do not mix them.

Any line can be broken and continued on the next line by using a
\e character as the last character on the line.

The \fBlogin-class\fP class and the \fBlogin-regexp\fP word are evaluated as
regular expressions.
The \fBdev-class\fP and the \fBdev-glob\fP word are evaluated as
shell-style globs.  If a name given corresponds to a directory, and
if it is a mount point listed in \fI/etc/fstab\fP, the device node
associated with the filesystem mounted at that point will be
substituted in its place.

Classes are denoted by being contained in \f(CR<\fR angle bracket \f(CR>\fR
characters; a lack of \f(CR<\fR angle brackets \f(CR>\fR indicates that
the string is to be taken literally as a \fBlogin-regexp\fP or a
\fBdev-glob\fP, depending on its input position.
.SH "SEE ALSO"
.BR pam_console (8)
.br
.BR pam_console_apply (8)
.br
.BR console.apps (5)
.SH AUTHOR
Michael K. Johnson <johnsonm@redhat.com>
